home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 June / EnigmA AMIGA RUN 19 (1997)(G.R. Edizioni)(IT)[!][issue 1997-06][EAR-CD III].iso / for amiga / v2.1 / boot / amiboot-5.1.readme < prev    next >
Text File  |  1997-04-23  |  7KB  |  242 lines
  1.  
  2.         Linux/m68k Amiga Bootstrap version 5.1
  3.         --------------------------------------
  4.  
  5.  
  6. 0. Introduction
  7. ---------------
  8.  
  9. Amiboot is used to boot Linux/m68k on Amiga from the CLI/Shell.
  10.  
  11. Before you try to boot Linux/m68k for the first time, please read the FAQ
  12.  
  13.     http://www-agrw.informatik.uni-kl.de/~jmayer/linux68k/linux68k-faq
  14.  
  15. and the Installation Guide
  16.  
  17.     http://www.informatik.uni-oldenburg.de/~amigo/inst.html
  18.  
  19. first. Although the Installation Guide is getting a bit outdated, it's still a
  20. good starting point.
  21.  
  22. Amiboot 5.1 is meant for Linux/m68k 2.0.x, 2.1.x or higher (kernel bootinfo
  23. interface versions 1.x and 2.x). Please use an older version for older kernels.
  24.  
  25.  
  26. 1. Running Amiboot
  27. ------------------
  28.  
  29. The Amiboot invocation syntax looks like
  30.  
  31.     amiboot [options] [kernel command line]
  32.  
  33. Valid options are:
  34.  
  35.     --help           Display the usage information
  36.  
  37.     --kernel file    Use kernel image `file' (default is `vmlinux')
  38.  
  39.     --ramdisk file   Use ramdisk image `file'.
  40.  
  41.     --debug          Enable debug mode
  42.  
  43.     --baud           Set the serial port speed (default is 9600)
  44.  
  45.     --memfile file   Use memory file `file'
  46.  
  47.     --keep-video     Don't reset the video mode
  48.  
  49.     --model id       Set the Amiga model to `id'.
  50.  
  51. The kernel command line contains the options you want to pass to the kernel and
  52. to init, the process that's started first by Linux. Please read
  53. linux/Documentation/m68k/kernel-options.txt for more information.
  54.  
  55. Normally you only use the --kernel option to specify the file that contains the
  56. Linux/m68k kernel image, and --ramdisk if you want to boot from a ramdisk file,
  57. i.e. a file containing a complete file system, instead of from a hard disk
  58. partition.
  59.  
  60. Example:
  61.  
  62.     amiboot -k vmlinux-2.1.13 root=/dev/hda3 video=font:PEARL8x8
  63.  
  64. Amiboot will boot the kernel image `vmlinux-2.1.13' and will pass
  65. `root=/dev/hda3 video=font:PEARL8x8' to the kernel.
  66.  
  67.  
  68. The other options are more specialized. Don't use them unless you really have
  69. to and you know what you're doing.
  70.  
  71. The --baud option allows you to specify the serial port speed for initial boot
  72. information and initial kernel messages. Note: this option does not work with
  73. kernels with bootinfo interface versions prior to 2.0.
  74.  
  75. The --memfile option is used to specify the blocks of memory that will be used
  76. by Linux.
  77.  
  78. The --keep-video option is necessary if you want to retain the current graphics
  79. mode (on a graphics board) under Linux. Currently this is only useful if you
  80. have a CyberVision 64 graphics board.
  81.  
  82. Finally, --model allows you to specify your Amiga model, and --debug is for
  83. debugging purposes.
  84.  
  85.  
  86. 2. The memory file
  87. ------------------
  88.  
  89. If you have some non-AutoConfig memory you want to use under Linux, or if you
  90. want to disable some parts of your memory (e.g. Zorro II RAM on '040 based
  91. systems), you have to use a memory file and the --memfile option. This file
  92. contains information about the memory chunks you want to use under Linux. The
  93. format for the file is:
  94.  
  95.     chipramsize
  96.     [0xfastchunkaddr fastchunksize]
  97.     [0xfastchunkaddr fastchunksize]
  98.     ...
  99.  
  100. For example, if you don't want Linux to use your 2nd meg of chipram, you would
  101. create a file that looks contains only:
  102.  
  103.     1048576
  104.  
  105. If you had 1M of chip ram, 2M of 16 bit FAST ram at address 0x200000 and 16M of
  106. 32 bit FAST ram at address 0x80000000, and you didn't want Linux to use the
  107. slow 16 bit FAST ram, you'd create a file that looks like:
  108.  
  109.     1048576
  110.     0x80000000 16777216
  111.  
  112. The memory file can also be used to specify in which block of memory the kernel
  113. will be put. Normally Amiboot will put the kernel in the first block of Fast
  114. RAM it will find. If you use a memory file, it will put the kernel in the first
  115. block of fast RAM you specify.
  116.  
  117.  
  118. 3. Amiga models
  119. ---------------
  120.  
  121. If Amiboot incorrectly detects the model of your Amiga, you can force it to
  122. detect any model you want using the --model option. `id' must be one of the
  123. numbers as defined in linux/include/asm-m68k/amigahw.h (AMI_*). Currently the
  124. following models are known:
  125.  
  126.     Model        ID
  127.     -----        --
  128.     Amiga 500         1
  129.     Amiga 500+         2
  130.     Amiga 600         3
  131.     Amiga 1000         4
  132.     Amiga 1200         5
  133.     Amiga 2000         6
  134.     Amiga 2500         7
  135.     Amiga 3000         8
  136.     Amiga 3000T         9
  137.     Amiga 3000+        10
  138.     Amiga 4000        11
  139.     Amiga 4000T        12
  140.     CDTV        13
  141.     CD32        14
  142.     Draco        15
  143.  
  144. Note that Amiboot can't distinguish among Amiga models that are very similar to
  145. each other (e.g. A500/A1000/A2000/A2500 and A3000/A3000T). Of course this is
  146. harmless and there's no real need to use --model in that case.
  147.  
  148. Please send me the output of amiboot used with the --debug option if your Amiga
  149. model is detected incorrectly.
  150.  
  151.  
  152. 4. Abbreviations
  153. ----------------
  154.  
  155. All options also have a shorthand:
  156.  
  157.     --help         -h
  158.     --kernel        -k
  159.     --ramdisk        -r
  160.     --debug        -d
  161.     --baud        -b
  162.     --memfile        -m
  163.     --keep-video    -v
  164.     --model        -t
  165.  
  166.  
  167. 5. Miscellaneous
  168. ----------------
  169.  
  170. Some expansion boards keep on generating interrupts once they were initialized
  171. under AmigaOS. This can cause an interrupt deadlock while booting Linux. The
  172. following boards are recognized and disabled:
  173.  
  174.     o Helfrich Rainbow 3 Graphics Board
  175.     o Helfrich Piccolo Graphics Board
  176.     o Helfrich SD64 Graphics Board
  177.     o Village Tronic Ariadne Ethernet Board
  178.     o Hydra Systems Amiganet Ethernet Board
  179.  
  180. The following boards are known to cause problems but we don't have a disable
  181. routine for them yet:
  182.  
  183.     o Commodore A2060 Arcnet Card
  184.     o Ameristar A560 Arcnet Card
  185.  
  186. If you write a routine to disable an expansion board, please let me know.
  187.  
  188.  
  189. 6. Troubleshooting
  190. ------------------
  191.  
  192.   - Amiboot says
  193.  
  194.     This bootstrap is too old/new for this kernel
  195.  
  196.     This means that you're using a version of Amiboot that's not compatible
  197.     with the kernel you want to boot.
  198.  
  199.     Solution: use the correct Amiboot, or use another kernel.
  200.  
  201.   - Amiboot says
  202.  
  203.     Warning: too many AutoConfig devices. Ignoring device at 0x????????
  204.  
  205.     or
  206.  
  207.     Warning: too many memory blocks. Ignoring block of ???K at 0x????????
  208.  
  209.     This means that you have more AutoConfig devices or memory chunks than
  210.     Amiboot supports. Note that you can still boot Linux/m68k, but that the
  211.     additional devices or memory blocks can't be used.
  212.  
  213.     Solution: increase the ZORRO_NUM_AUTO (for AutoConfig devices) or
  214.     NUM_MEMINFO (for memory chunks) values in the kernel sources
  215.     (linux/include/asm-m68k/zorro.h and linux/include/asm-m68k/setup.h) and
  216.     recompile both Amiboot and the kernel.
  217.  
  218.   - If all you get is a grey screen, or if Linux/m68k suddenly locks up during
  219.     booting, try the following things:
  220.  
  221.       o Boot with the Startup-Sequence disabled, run SetPatch and try again.
  222.  
  223.       o If that doesn't work, remove any expansion devices and retry.
  224.  
  225.       o Look at the characters that are dumped to the serial port during
  226.     booting.
  227.  
  228.  
  229. 7. Amiga-Lilo
  230. -------------
  231.  
  232. Once you have a stable Linux/m68k installation, you may want to try Amiga-Lilo.
  233. Amiga-Lilo allows you to boot Linux/m68k without the overhead of booting
  234. AmigaOS first, and it provides you with a boot menu.
  235.  
  236.  
  237. 8. Credits
  238. ----------
  239.  
  240. This readme was written by Geert Uytterhoeven. A lot of information was taken
  241. from the ANNOUNCE-* files by Hamish Macdonald.
  242.